Skip to main content
GET
/
files
/
{id}
Download file
curl --request GET \
  --url https://{subdomain}.storage.{region}.nhost.run/v1/files/{id} \
  --header 'Authorization: Bearer <token>'

Authorizations

​
Authorization
string
header
required

API key to authorize requests.

Headers

​
if-match
string

Only return the file if the current ETag matches one of the values provided

​
if-none-match
string

Only return the file if the current ETag does not match any of the values provided

​
if-modified-since
string

Only return the file if it has been modified after the given date Date in RFC 2822 format

Example:

"Tue, 12 Aug 2025 12:03:50 GMT"

​
if-unmodified-since
string

Only return the file if it has not been modified after the given date Date in RFC 2822 format

Example:

"Tue, 12 Aug 2025 12:03:50 GMT"

​
Range
string

Range of bytes to retrieve from the file. Format: bytes=start-end

Path Parameters

​
id
string
required

Unique identifier of the file to download

Query Parameters

​
q
integer

Image quality (1-100). Only applies to JPEG, WebP, PNG and HEIC files

Required range: 1 <= x <= 100
​
h
integer

Maximum height to resize image to while maintaining aspect ratio. Only applies to image files

Required range: x >= 1
​
w
integer

Maximum width to resize image to while maintaining aspect ratio. Only applies to image files

Required range: x >= 1
​
b
number

Blur the image using this sigma value. Only applies to image files

Required range: x >= 0
​
f
enum<string>
default:same

Output format for image files. Use 'auto' for content negotiation based on Accept header

Available options:
auto,
same,
jpeg,
webp,
png,
avif,
heic
Example:

"same"

Response

File content retrieved successfully